| CFHEADER | |
| Description | |
| Generates custom HTTP response headers to return to the client. | |
| Category | |
| Data output tags, Page processing tags | |
Syntax<cfheader name = "header_name" value = "header_value" charset="charset"> or <cfheader statusCode = "status_code" statusText = "status_text"> |
|
| See also | |
| cfcache, cfflush, cfhtmlhead, cfinclude, cfsetting, cfsilent, cfcontent | |
| History | |
| ColdFusion MX 6.1: Changed behavior for the name attribute: cfheader name="Content-Disposition" uses the default file character encoding to encode this header's value, so the name of a file can include characters in the character encoding used in the file. | |
| Usage | |
| If you use this tag after the cfflush tag on a page, an error is thrown. | |
Example<h3>cfheader Example</h3> <p>cfheader generates custom HTTP response headers to return to the client. <p>This example forces browser client to purge its cache of requested file. <cfheader name = "Expires" value = "#Now()#"> |
|
| NAME | |
| Required if statusCode not specified | |
|
Header name |
|
| VALUE | |
| Optional | |
|
HTTP header value |
|
| CHARSET | |
| Optional | |
|
Default value: "UTF-8"
The character encoding in which to encode the header value. The following list includes commonly used values:
For more information character encodings, see:www.w3.org/International/O-charset.html. |
|
| STATUSCODE | |
| Required if name not specified | |
|
Number. HTTP status code |
|
| STATUSTEXT | |
| Optional | |
|
Explains status code |
|